home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr22 / dfat22.zip / DFAT.DOC next >
Text File  |  1993-05-25  |  8KB  |  167 lines
  1.  
  2.                                DFAT 2.2
  3.                        [short for Directory FAT]
  4.  
  5.                 Shows file clusters in directory groups
  6.  
  7.                                   by
  8.  
  9.                                Bob Eyer
  10.                         Compuserve [73230,2620]
  11.                   INTERNET: 73230.2620@compuserve.com
  12.  
  13.                              May 25, 1993
  14.  
  15.      ┌────────────────────────────────────────────────────────────────┐
  16.      │                                                                │
  17.      │     Like  the  idea  of a BBS program that works at a basic    │
  18.      │     level with no configuration  at  all--a  miniature  BBS    │
  19.      │     which  can  be  made  as sophisticated as you like, but    │
  20.      │     which can be run as a simple utility if you forget  how    │
  21.      │     to use it?  Try HOSP.  Lots of people like it.  And you    │
  22.      │     can  have  a  copy  for  only  $25 (the basic shareware    │
  23.      │     charge plus $5).  That contribution pays  for  HOSP  as    │
  24.      │     well as some four dozen plus additional utilities, many    │
  25.      │     of  which  cover  territory nowhere else reviewed.  See    │
  26.      │     SHARE.TXT for details.  For preview,  try  most  recent    │
  27.      │     version  of  HOST  in  Library 1 of Compuserve's IBMBBS    │
  28.      │     Forum.  (Search for MINIATURE in Lib 1)                    │
  29.      │                                                                │
  30.      └────────────────────────────────────────────────────────────────┘
  31.  
  32.  
  33.  
  34.        WARNING: This program is  not  intended  to  be  used  in  drive
  35.        partitions defined with capacity exceeding 32 megabytes.
  36.  
  37.  
  38.        Syntax
  39.        ------
  40.        DFAT [path] [cluster] [/P] [/S] [>file]
  41.  
  42.        Parameters
  43.        ----------
  44.  
  45.        path       Drive/subdirectory on which to run DFAT.
  46.                   The default is the local directory.   This  parameter
  47.                   requires  the  use  of the colon in the drive name if
  48.                   DFAT is to recognise a different drive.  If you  want
  49.                   the  root  directory  and are not in it, just use the
  50.                   drive name without any backslash.
  51.  
  52.                   If a subdirectory is mentioned as a part of the path,
  53.                   it must begin with a backslash.  DFAT suppresses path
  54.                   defaults on other drives.  Do NOT  include  filenames
  55.                   or  wildcards  in  the path (DFAT will interpret them
  56.                   as directories, and so not find them).
  57.  
  58.                   A   little   experimentation   will   show  how  this
  59.                   parameter is used.
  60.  
  61.                   If  DFAT  is  made  to  operate  on  a nonexistent or
  62.                   unready drive, it will simply flip back to the  local
  63.                   drive  and  present  the appropriate disk report.  If
  64.                   the user's subdirectory does  not  exist,  DFAT  will
  65.                   report that fact.
  66.  
  67.                   Examples of syntactically valid paths:
  68.  
  69.                   D:
  70.                   d:\sys
  71.                   \SYS\CIS\
  72.                   c:\util\a
  73.  
  74.        cluster    The  first  cluster  number of the subdirectory to be
  75.                   viewed.  If not entered and if only drive information
  76.                   appears on the command line, DFAT simply presents the
  77.                   root  directory  from  which  the cluster numbers for
  78.                   subdirectories can be  obtained.
  79.  
  80.                   Use of a value for cluster  that  does  not  actually
  81.                   correspond  to any actual subdirectory causes DFAT to
  82.                   abort with an appropriate error message.
  83.  
  84.                   This  parameter  is  ignored  where the user enters a
  85.                   path containing valid subdirectory information.
  86.  
  87.        /P         Pagination switch.
  88.  
  89.        /S         Short form.
  90.                   Where  activated,  this  switch  suppresses all video
  91.                   output except the final  disk  summary.   Useful  for
  92.                   including DFAT in AUTOEXEC.BAT.
  93.  
  94.        [>file]    If the directory is very  long,  you  might  redirect
  95.                   DFAT  output to a file and view the result using your
  96.                   lister or editor.
  97.  
  98.        Note: parameter order is important.  If a path is mentioned,  it
  99.        must  be  listed  first  on  the command line.  Switches must be
  100.        mentioned last.
  101.  
  102.  
  103.        Changes in DFAT 2.2
  104.        -------------------
  105.        - Tests for total space on given logical drive; if in excess
  106.          of 32 megabytes, DFAT aborts to DOS with an appropriate
  107.          error message.
  108.  
  109.        Changes in DFAT 2.1
  110.        -------------------
  111.        - Addition of pagination and short-form switches
  112.        - Cosmetic changes to effect briefer displays
  113.        - If neither path nor cluster number entered,
  114.           DFAT defaults directory to local directory
  115.           instead of root
  116.        - Increases subdirectory capacity
  117.        - Fixes bug which caused erroneous fragment counts
  118.           on small drives
  119.        - Largely fixes bug which caused string-allocation
  120.           hangs on some machines
  121.  
  122.        Discussion
  123.        ----------
  124.        The  primary  purpose  of  this  program  is  to  measure   file
  125.        fragmentation  on  given  disks  taken as a whole, as well as to
  126.        show it in the  user's  selected  directory.
  127.  
  128.        The initial cluster of each file is not a fragment; where a file
  129.        is  fragmented,  its  fragments consist of those parts which are
  130.        not physically contiguous on the disk's tracks with that  file's
  131.        initial  cluster,  or  with  other  fragments  of the same file.
  132.        Thus, a file which is physically  integrated  by  DOS  from  two
  133.        discontiguous  media  images  is  said  to  have one "fragment".
  134.        Where a file has fragments, they are separated by a single space
  135.        in DFAT's listing.
  136.  
  137.        DFAT  counts  all  fragments on the disk (as recursively defined
  138.        above) and prepares a percentage evaluation shown  on  the  last
  139.        line  of video output.  This percentage is injected to DOS as an
  140.        errorlevel for batch file processing.
  141.  
  142.        Generally speaking, it's time to defrag your disk, if DFAT shows
  143.        fragmentation percentages approaching 10%, especially  on  disks
  144.        which  show  relatively little free space.  Always do a complete
  145.        backup before defragging.  Failure to respond  appropriately  to
  146.        the  buildup  of  file  fragmentation  is one of the most common
  147.        causes of drive failure.
  148.  
  149.        The  inspiration for DFAT was Chris Dunford's excellent FAT 1.09
  150.        (appearing in IBMSYS's Library 1 as FAT.ARC).  However, I needed
  151.        a program whose output looked more like a DOS directory.  I also
  152.        wished to extend the program to provide errorlevel output on the
  153.        percentage measure of  fragmentation,  much  as  does  PC  Mag's
  154.        interesting program CHKFRAG by Bob Flanders et al.
  155.  
  156.        I thought others would appreciate such revisions, as well.
  157.  
  158.        An  important  difference  between  CHKFRAG and DFAT is that the
  159.        former  defines  fragmentation  in  terms  of  the   number   of
  160.        fragmented  files.   DFAT,  however,  counts  fragments  as such
  161.        without regard to how  they  are  distributed  among  files  and
  162.        subdirectories.   For  this  reason,  DFAT  arrives  at slightly
  163.        different results.
  164.  
  165.        -------------------------
  166.        End of documentation
  167.